Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Application Messages

GXCleanupStartPage

QuickDraw GX sends the GXCleanupStartPage message if a message handler fails during the processing of a GXStartPage message. You can override the GXCleanupStartPage message to deallocate any storage allocated during processing of the GXStartPage message. Your override of the GXCleanupStartPage message must match the following formal declaration:

void MyCleanupStartPage (void);

DESCRIPTION

QuickDraw GX sends the GXCleanupStartPage message after it receives a GXCleanupStartPage function call from a message handler that failed during a GXStartPage override and after forwarding the GXStartPage message.

You need to override the GXCleanupStartPage message if you perform an operation that must be undone within the GXStartPage message override. For example, your attempt to allocate memory or initialize a device after forwarding the GXStartPage message may fail. When you receive this message, you typically deallocate any storage you were using because of GXStartPage.

The default implementation of GXCleanupStartPage disposes of the memory that was allocated during the default implementation of the GXStartPage message.

SPECIAL CONSIDERATIONS

You never send the GXCleanupStartPage message yourself; however, you can call the GXCleanupStartPage function, which then sends this message.

You must forward the GXCleanupStartPage message to other message handlers.

SEE ALSO

The GXStartPage message is described in the previous section.

The GXCleanupStartPage function is described on page 5-37 in the chapter "Printing Functions for Message Overrides."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help